home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Night Owl 19
/
Night Owl (The Best of Shareware)(NOPV 19)(1996).ISO
/
031a
/
dirrpt13.zip
/
DIRRPT.DOC
next >
Wrap
Text File
|
1995-05-24
|
9KB
|
200 lines
DIRECTORY REPORT V1.3 USER'S GUIDE
May 22, 1995
1.0 GENERAL DESCRIPTION
DIRRPT.EXE is a public domain MS-DOS utility to quickly determine
the directory/file structure of a drive, especially CDROMs and
large hard disks. DIRRPT.EXE performs the following functions:
a. Scan a user specified drive and optional directory, to list
all subdirectory names with total files and total bytes in
each subdirectory.
b. Show total files and total bytes for all directories in the
specified drive and optional directory.
c. View the directory list using the cursor keys to scroll
backward and forward thru the directory list.
d. Display a list of file names with size, date, time for each
highlighted directory by pressing the <Enter> key and using
the cursor keys to scroll backward and forward thru the file
list.
e. Display the contents of a highlighted file by pressing the
<Enter> key and using the cursor keys to scroll forward,
backward, left, and right thru the file.
f. Save the directory list, with or without individual file
information, to a user specified file.
It is recommended that DIRRPT.EXE and this document, ASCII file
DIRRPT.DOC, be installed in a directory that is in the DOS PATH
statement so that DIRRPT can be run from any drive and
subdirectory. DIRRPT uses the 80 column, 25 line text display
mode.
2.0 MAIN MENU
Use the cursor/enter keys or enter the first uppercase or
lowercase letter (g, v, s, h, q) to select the desired operation.
Get New Drive, Directory
View Report
Save Report To File
Help
Quit Program
The "Get New Drive, Directory" operation is required before the
"View Report" and "Save Report To File" operations.
The following sections describe each operation.
3.0 GET NEW DRIVE, DIRECTORY
Load a new drive letter and optional directory to make it the
current drive\directory for the "View Report" and "Save Report To
File" operations.
- 2 -
DIRECTORY REPORT V1.3 USER'S GUIDE (Cont)
If, at the "Enter drive:\dir(opt):" prompt, only the <Enter> key
is pressed, the current drive and root directory will be used. If
only a drive letter is entered, the root directory of the drive
letter will be used.
A drive and subdirectory(s) can be entered using the <Left>,
<Right>, <Home>, <End>, <BackSpace> and <Del> keys to edit the
entry. Press the <Ins> key, to toggle editing between overstrike
mode (replace character at cursor) and insert mode (move character
at cursor to right). Editing always starts in the overstrike
mode.
The subdirectory entry can include wildcard characters "?" and
"*". For example, C:\D* will list all directories on drive C
that begin with D, including all subdirectories in the DXXX
directory.
The drive and subdirectory can also be entered on the command line
when DIRRPT is loaded. For example, DIRRPT C will bypass the main
menu and list all directories on drive C. The main menu will be
displayed after the quiting the "View Report" operation.
The operation will be canceled if an invalid drive, invalid
directory or empty drive is requested.
The directories will be scanned to acquire the file and byte
totals for each directory. The list will be sorted in order of
directory name and then displayed as described in Section 4.1.
The total number of directories, files, and bytes will also be
displayed.
The directory list will be the "current list" that is processed by
the "View Report" and "Save Report To File" operations until
another "Get New Drive, Directory" operation is performed.
DIRRPT can process up to 2,048 directories, 2,048 files in each
directory, 65,535 total files, and 2,147,483,647 bytes in all
directories.
On CDROM drives, if a "Drive not ready. Abort, Retry, Fail"
message occurs, press "r" to continue scanning the drive.
- 3 -
DIRECTORY REPORT V1.3 USER'S GUIDE (Cont)
4.0 VIEW REPORT
4.1 Directory List
Each line in the current directory list contains the complete
drive\directory name, and the number of files/bytes in that
directory only. If the list is longer than will fit inside the
display window, a "More" indicator will appear at the top and/or
bottom of the window. Use the <Up>, <Down>, <PgUp>, <PgDn>,
<Home>, and <End> keys to scroll one line backward/forward, one
screen backward/forward, and to the beginning/end of the list.
Press the <Esc> key to return to the main menu.
4.2 File List
To display the files in the highlighted directory, press the
<Enter> key to open another window. The file list contains size,
date and time for each file, sorted in order of file name. It is
scrolled in the same way as the directory list. Hidden and system
files are included in the list. Press the <Esc> key to return to
the directory list.
4.3 File Viewer
To display the contents of the highlighted file, press the <Enter>
key. A full screen window shows the contents of the file. Use the
<Up>, <Down>, <PgUp>, <PgDn>, <Home>, and <End> keys to scroll
one line backward/forward, one screen backward/forward, and to the
beginning/end of the file. Use the <Left> and <Right> keys to
scan left/right 8 columns. Use the <Ctrl-Left> key to position
the 1st column of text to the left edge of the display. Use the
<Ctrl-Home> key to perform the <Ctrl-Left> function and go to the
beginning of the file. Non-text files (.EXE, .COM, .SYS, .BIN,
etc.) don't show a meaningful display. The viewer can display the
first 16,000 lines of the file and up to 255 characters per line.
If the line contains more than 255 characters before the CR/LF
characters, it is wrapped to the next line. Press the <Esc> key
to return to the file list.
5.0 SAVE REPORT TO FILE
The current directory list, with optional individual file info, is
saved to a user specified file name. The program asks "Include
each file's name, size, date, and time? (Y/N) ". Press "y" or "Y"
to include individual file info in the report. Next, the program
asks "Enter file name (Esc: Cancel): DIRRPT.LST". Press <Enter>
only to accept the default file name or enter/edit a file name and
optional directory as described in Section 3.0. If only the <Esc>
key is pressed, the operation will be canceled.
- 4 -
DIRECTORY REPORT V1.3 USER'S GUIDE (Cont)
If the specified file already exists, the program asks "File
already exists. Overwrite? (Y/N) ". Press "y" or "Y" to
overwrite the specified file. Press "n" or "N" to cancel the
operation and return to the main menu.
An ASCII text file is generated. The first line contains the
drive\directory name being scanned with the total number of
directories, files and bytes for all directories in the list. The
second line is blank. The third line is the names of the list
columns (Dir, Files, Bytes). The rest of the lines are the
directory list as displayed in Section 4.1 and optional file list
for each directory as displayed in Section 4.2.
6.0 HELP
"Help" provides a brief description of DIRRPT. Press any key to
return to the main menu.
7.0 REVISION HISTORY
1.0 Initial release.
1.1 Add a file viewer individual file data option to Report To
File operation.
1.2 Correct bug in individual file data option of Report To File
that causes computer to lockup.
1.3 Add wildcard character (?, *) option to directory entry.
Allow initial drive and directory to entered on the command
line when loading DIRRPT.
8.0 ADDITIONAL INFORMATION
For additional information, comments, or suggestions on the
DIRRPT Directory Report program, contact John Haluska,
74000.1106@compuserve.com.
DIRRPT.DOC